排查 Office 加载项中的开发错误

您所在的位置:网站首页 pdf makerofficeaddin加载项问题 排查 Office 加载项中的开发错误

排查 Office 加载项中的开发错误

2023-04-12 21:33| 来源: 网络整理| 查看: 265

排查 Office 加载项中的开发错误 项目 03/15/2023

下面是开发 Office 外接程序时可能遇到的常见问题的列表。

提示

清除 Office 缓存通常会修复与过时代码相关的问题。 这可确保使用当前文件名、菜单文本和其他命令元素上传最新的清单。 若要了解详细信息,请参阅 清除 Office 缓存。

外接程序无法在任务窗格中加载,或外接程序清单存在其他问题

请参阅验证 Office 加载项的清单和使用运行时日志记录功能调试加载项,以调试加载项清单问题。

对加载项命令(包括功能区按钮和菜单项)的更改未生效

清除缓存有助于确保使用外接程序清单的最新版本。 若要清除 Office 缓存,请按照 清除 Office 缓存中的说明进行操作。 如果使用Office web 版,请通过浏览器的 UI 清除浏览器缓存。

对静态文件(例如 JavaScript、HTML 和 CSS)的更改未生效

浏览器可能正在缓存这些文件。 若要阻止此操作,请在开发时关闭客户端缓存。 详细信息取决于你所使用的服务器类型。 在大多数情况下,它涉及将某些标头添加到 HTTP 响应。 建议使用以下集。

Cache-Control:“private、no-cache、no-store” Pragma:“no-cache” 过期:“-1”

有关在 Node.JS Express 服务器中执行此操作的示例,请参阅此 app.js 文件。 有关 ASP.NET 项目中的示例,请参阅此 cshtml 文件。

如果加载项托管在 Internet Information Server (IIS) 中,则还可以将以下内容添加到 web.config 中。

如果这些步骤一开始似乎不起作用,则可能需要清除浏览器的缓存。 请通过浏览器的 UI 执行此操作。 有时,当你尝试在边缘 UI 中清除边缘缓存时,无法成功清除它。 如果出现这种情况,请在 Windows 命令提示符中运行以下命令。

del /s /f /q %LOCALAPPDATA%\Packages\Microsoft.Win32WebViewHost_cw5n1h2txyewy\AC\#!123\INetCache\ 不会对属性值进行更改,并且没有错误消息

查看属性的参考文档,了解它是否为只读。 此外,Office JS 的 TypeScript 定义 指定哪些对象属性是只读的。 如果尝试设置只读属性,写入操作将以无提示方式失败,并且不会引发错误。 以下示例错误地尝试设置只读属性 Chart.id。另请参阅 某些属性无法直接设置。

// This will do nothing, since `id` is a read-only property. myChart.id = "5"; 出现错误:“此加载项不再可用”

下面是导致此错误的一些原因。 如果发现其他原因,请使用页面底部的反馈工具告诉我们。

如果使用 Visual Studio,则旁加载可能存在问题。 关闭 Office 主机和 Visual Studio 的所有实例。 重启 Visual Studio 并再次尝试按 F5。 加载项清单已从其部署位置(例如集中部署、SharePoint 目录或网络共享)中删除。 清单中 ID 元素的值已直接在已部署的副本中更改。 如果出于任何原因想要更改此 ID,请先从 Office 主机中删除加载项,然后将原始清单替换为已更改的清单。 许多人需要清除 Office 缓存以删除原始的所有跟踪。 有关清除操作系统缓存的说明,请参阅 清除 Office 缓存一文。 加载项的清单具有 resid 未在清单的“资源”部分的任何位置定义的 ,或者 使用位置与“资源>”部分中定义 节中属性窗口 ”。 设置manifest.xml中的光标选择,以便 “属性” 窗口显示 XML 文档 属性。 在 “属性” 窗口中,选择“ 架构” 属性,然后选择省略号 (...) 打开 XML 架构 编辑器。 可在此处找到项目使用的所有架构文件的确切文件夹位置。

更新 XSD 文件 在文本编辑器中打开要更新的 XSD 文件。 验证错误中的架构名称将与 XSD 文件名相关联。 例如,打开 TaskPaneAppVersionOverridesV1_0.xsd。 在 [MS-OWEMXML]:附录 A:完整 XML 架构中找到更新的架构。 例如,TaskPaneAppVersionOverridesV1_0位于 taskpaneappversionoverrides 架构中。 将文本复制到文本编辑器中。 保存更新的 XSD 文件。 重启 Visual Studio 以选取新的 XSD 文件更改。

对于已过期的任何其他架构,可以重复上述过程。

脱机工作时,没有 Office API 工作

从本地副本而不是 CDN 加载 Office JavaScript 库时,如果库不是最新的,API 可能会停止工作。 如果已离开项目一段时间,请重新安装库以获取最新版本。 该过程因 IDE 而异。 根据环境选择以下选项之一。

Visual Studio:请参阅 更新到最新的 Office JavaScript API 库。 任何其他 IDE:请参阅 npm 包@microsoft/office-js 和 @types/office-js。 另请参阅 在 Office 网页版中调试加载项 在 Mac 上旁加载 Office 加载项 在 iPad 上旁加载 Office 加载项 在 Mac 上调试 Office 加载项 适用于 Visual Studio Code 的 Microsoft Office 加载项调试器扩展 验证 Office 加载项的清单 使用运行时日志记录功能调试加载项 排查 Office 加载项中的用户错误 Office 加载项中的运行时 Microsoft Q&A (office-js-dev)


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3